home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / dev / debug / GAngelRmx.readme < prev    next >
Encoding:
Text File  |  1996-05-05  |  6.9 KB  |  146 lines
  1. Short:    Protect free memory. 040/3.x needed.
  2. Author:   Børge Nøst <borgen@icenet.no / bn.f1901.adir@gmail.gar.no>
  3. Uploader: borgen@icenet.no
  4. Type:     dev/debug
  5.  
  6.  
  7. Full program name: Guardian Angel Remix.
  8.  
  9. This program will protect all free pages in memory. It requires a 68040 and
  10. KickStart 3.0/3.1 (versions prior to these will not work - sorry), and also
  11. needs SetPatch and Enforcer to be run before it is started. Only works with
  12. 4K page size.
  13.  
  14. You will not find much use in it unless Enforcer has been started too.
  15. This version will not function properly if you quit Enforcer after GAR has
  16. been started. (Your machine will crash if you do.)
  17. (In short: Start SetPatch, start Enforcer, start GAR.)
  18.  
  19. To test that it is working you can use a monitor (like Amiga Monitor 1.65 by
  20. Timo Rossi) and do a little memory dump to screen from an address you know to
  21. be free. You should now get Enforcer hits that says memory was read at
  22. somesuch address.
  23.  
  24. If a program reads or writes to pages in memory that are completely free you
  25. will get a hit message from Enforcer.
  26.  
  27. Hope you find this utility useful.
  28.  
  29.  
  30. The directory names have the following meaning:
  31. No_Write    Writing to free memory shows an Enforcer hit
  32. No_Read        Writing _and_ reading to free memory shows an Enforcer hit
  33. MungMem        Memory is filled with $DEADF00D before Alloc#?() returns
  34. Scratch        Scratch registers are set to $BADBAD00 when the patched OS
  35.         calls return.
  36. Combine these names to see what effect the different binaries gives.
  37. I use the No_Read-MungMem-Scratch combination myself.
  38.  
  39.  
  40. Guardian Angel Remix is a ShareWare program as ShareWare was once defined:
  41. You get the complete uncrippled(sp?) program and you're only asked to pay
  42. the author if you find it useful.
  43. I would be happy to receive $5 if you find GAR worth using. If you like you
  44. might send paper notes in your local currency, a box of chocolate, an old
  45. original game for the C= 64 or the Amiga, a registered version of your own
  46. ShareWare program, a nice techno/house/jungle CD, a box of blank disks, a DAT
  47. tape, or an Amiga CD.
  48.  
  49.  
  50. (Here follows some comments from the source:)
  51. *******************************************************************************
  52. *******************************************************************************
  53. *******************************************************************************
  54. *******                                    *******
  55. *******    Guardian Angel Remix                        *******
  56. *******                                    *******
  57. *******    Once upon a time a long long ago, there was this utility called    *******
  58. *******    "Guardian Angel". A few had heard of it, some had seen it, but    *******
  59. *******    none could make it work (or so the story goes). This fabled    *******
  60. *******    program was said to protect your free memory so that you could    *******
  61. *******    trap your nasty errors. As destiny would happen, I got a copy    *******
  62. *******    of this program, and lo and behold, it seemed such a nice idea,    *******
  63. *******    but the implementation left a lot to be desired: It was 68020/    *******
  64. *******    68030 only, used 256 bytes page size, rounded all allocations     *******
  65. *******    up to a multiple of 256, and allocated the largest free chunk    *******
  66. *******    of memory to be your new memory that could be alloacted from.    *******
  67. *******    Enter the time machine and warp forwards to the year 1994 where    *******
  68. *******    the CyberStorm060 card is released. Because Enforcer doesn't    *******
  69. *******    work with the 68060, the utility "CyberGuard" is shipped with    *******
  70. *******    it. Imagine the surprise when it is discovered to have a    *******
  71. *******    "guard" option. Yes, the Guardian Angel is back in a new    *******
  72. *******    disguise. A new implementation, but it still aims to protect    *******
  73. *******    your free memory. And this time it works! Only oh-so-slowly.    *******
  74. *******    However, some of us (well, at least me) are willing to trade    *******
  75. *******    compatability with solutions that works well enough to be used    *******
  76. *******    today. This is my story of how I stole the OS code and added a    *******
  77. *******    little of my own sparkle. Enjoy (or frustrate as may be if you    *******
  78. *******    find new bugs in your programs :-).                *******
  79. *******                                    *******
  80. *******    Going with the times I have chosen to call it            *******
  81. *******    "Guardian Angel Remix" and here it is:                *******
  82. *******                                    *******
  83. *******************************************************************************
  84. *******************************************************************************
  85. *******************************************************************************
  86.  
  87. ;||
  88. ;|| Credits:
  89. ;||
  90. ;|| Thanks must go to Valentin Pepelea for the original Guardin Angel program
  91. ;|| and idea.
  92. ;|| Thanks also to Ralph Schmidt for implementing the 'guard' option in
  93. ;|| CyberGuard that made me think about this again. Thanks for the piece of
  94. ;|| code I used too.
  95. ;||
  96. ;|| Note that much of the patched code is copyright Amiga Technologies.
  97. ;|| I hope I can be allowed this as fair use in an example.
  98. ;||
  99. ;|| All other code, ideas, and implementation issues are my copyright.
  100. ;|| This program is allowed to be copied if no money is charged for the
  101. ;|| service, or in any other ways the receiver has to pay for it.
  102. ;|| AmiNet and Fred Fish have the permission to distribute this in their CD-ROM
  103. ;|| compilations.
  104. ;|| Commercial parties are encouraged to contact me for distribution rights.
  105. ;||
  106. ;||
  107. ;|| Børge Nøst, Safirveien 5, N-9022 Krokelvdalen, Norway
  108. ;|| bn.f1901.adir@gmail.gar.no
  109. ;||
  110.  
  111.  
  112. ;\\\\\\\\\\\\\
  113. ;\
  114. ;\  Incompatible programs found so far (using DEADLY versjon):
  115. ;\
  116. ;\  Term 4.5. Crashes on exit. Non-fatal. (Known to crash on exit on other
  117. ;\  machines not running GAR.) 'serial.device' stays in use.
  118. ;\  MungWall. This was expected and a calculated loss. Fatal.
  119. ;\  ARTM (probably). Expected to happen when 4K aligned header is found. Non-fatal.
  120. ;\  Virus Checker 7.18. Later versions gave me Enforcer hits anyway, but this
  121. ;\  version shows major problems with memory handling.
  122.  
  123.  
  124. ; allocations that live in parts of a page will not give hits when freed if
  125. ; there are other alloactions in the same page.
  126. ; this can be fixed by rounding up allocation size to a multiple of the page
  127. ; size and align the allocated addresses to page boundaries, but this will
  128. ; probably cost a _lot_ of memory
  129.  
  130.  
  131. ============================= Archive contents =============================
  132.  
  133. Original  Packed Ratio    Date     Time    Name
  134. -------- ------- ----- --------- --------  -------------
  135.     2620    1915 26.9% 02-Mar-96 04:36:52 +GuardianAngelRemix
  136.     2696    1945 27.8% 02-Mar-96 04:36:48 +GuardianAngelRemix
  137.     2688    1939 27.8% 02-Mar-96 04:36:50 +GuardianAngelRemix
  138.     2612    1909 26.9% 02-Mar-96 04:36:52 +GuardianAngelRemix
  139.     2608    1902 27.0% 02-Mar-96 04:36:56 +GuardianAngelRemix
  140.     2684    1934 27.9% 02-Mar-96 04:36:54 +GuardianAngelRemix
  141.     2676    1926 28.0% 02-Mar-96 04:36:54 +GuardianAngelRemix
  142.     2600    1899 26.9% 02-Mar-96 04:36:58 +GuardianAngelRemix
  143.     6254    2702 56.7% 02-Mar-96 04:36:48 +README
  144. -------- ------- ----- --------- --------
  145.    27438   18071 34.1% 08-Mar-96 03:14:58   9 files
  146.